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4. GRAPHICS EDITOR 
A. Part Introduction 

The graphics editor, ged(1G), is an interactive editor used to display, edit, and construct drawings on 
Tektronix 4010 series display terminals. Drawings are represented as a sequence of objects in a token language 
known as GPS. The GPS is produced by drawing commands in the UNIX operating system sia iat facili- 
ties such as vtoc(1G) and plot(1G), as well as by ged itself. 

Examples in this tutorial illustrate how to construct and edit simple drawings. It should be remembered 
that ged is intended to edit output of other programs rather than to construct drawings from scratch. In this 
part, literal keystrokes are printed in boldface and are surrounded by angled brackets. For example, <cr> 
means " return" and <sp> means " space" . In the examples, output from the terminal is printed in roman 
type. In-line comments are in roman font and are surrounded by parentheses. 


B. Commands 


It is assumed that while logged in at a display terminal the graphics(1) environment has been successfully 
entered. This is indicated with the * prompt character. To enter ged, the following is typed: 


ged<cr> 


After a moment, the screen should be clear except for the ged prompt which is *, in the upper left corner. The 
* indicates that ged is ready to accept a command. 


Each command passes through a sequence of stages during which a description of what the command is to 
do is to be provided. All commands pass through a subset of these stages: 


1. Command line 
2. Text 

3. Points 

4. Pivot 

5. Destination 


As arule, each stage is terminated by typing <er>. The <er> for the last stage of a command triggers exe- 
cution. 


Command Line 


The simplest commands consist only of a command line. The command line is modeled after a conventional 
command line in the shell. For example: 


commandname [—options] [filename] <cr> 


The ? is an example of a simple command. It lists commands and options understood by ged. The following is 
used to generate the list: 


*?<cr> (type a question mark followed by a return) 
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A command is executed by typing the first character of its name. The ged will echo the full name and wait 
for the rest of the command line. For example, e references the erase command. As erase consists only of 
stage 1, typing <er> causes the erase action to occur. Typing: 


<rubout> 


after a command name and before the final <er> for the command aborts the command. Thus while: 
*erase<cr> 
erases the display screen: 
*erase<rubout> 
brings the editor back to the (*) ged prompt. 
Following the command, options may be entered. Options control such things as width and style of lines 
to be drawn or size and orientation of text. Most options have a default value that applies if a value for the option 


is not specified on the command line. The set command allows examination and modification of default values. 
To see current default values, the following is typed: 


set<cr> 


The value of an option is either of type integer, character, or Boolean. Boolean values are represented by 
+ (for true) and — (for false). A default value is modified by providing it as an option to the set command. For 
example, to change default text height to 300 units, type: 


*set —h300<cr> 


Arguments on the command line, but not the command-name, may be edited using the erase and kill characters 
from the shell. This applies whenever text is being entered. 


Constructing Graphical Objects 


Drawings are stored as GPS in a display buffer internal to the editor. Typically, a drawing in ged is com- 
posed of instances of three graphical primitives: text, lines, and arcs. 


Generating Text 


To put a line of text on the display screen, the T command is used. The following stages accomplish this: 


io SESer> (enter command line) 


2. a line of text<er> (enter text) 
3. <position cursor><cr> (enter starting point for text). 


Positioning of the graphic cursor is done either with thumbwheel knobs on the terminal keyboard or with 
an auxiliary joystick. The <er> establishes the location of the cursor to be the starting point for the text string. 
The T command ends at stage 3, so this <er> initiates drawing of the text string. 


The T command accepts options to vary angle, height, and line width of the characters and to either center 
or right justify the text object. The text string may span more than one line by escaping the <er> (i.e.,\<cr>) 
to indicate continuation. The following illustrates some of these capabilities. 
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*T =r<er> (right justify text) 

top§<cr> : 

right<cr> 

<position cursor><cr> 

*T —a90<cr> (rotate text 90 degrees) 

left<er> 

<position cursor><cr> (pick a point below and left of 
the previous point) 


Results of these commands are shown in Fig. 4.1. 


top 
right 


lower 
left 


Fig. 4.1 Generating Text Objects 


Drawing Lines 


The L command is used to construct objects built from a sequence of straight lines. It consists of stages 
1 and 3. Stage 1 is: 


*L options<cr> 
The L command accepts options to specify line style and line width. 
Stage 3, the entering of points, is more interesting. Points are referenced either with the graphic cursor or 


by name. An example of entering a point with the cursor for the T command has previously been done. For the 
L command, it is more of the same. As an example, to build a triangle: 


*Leer> 

<position cursor><sp> (locate first point) 

<position cursor><sp> (locate second point) 

<position cursor> <sp> (locate third point) 

<position cursor> <sp> (return to first point) 

<¢r> (terminate points, draw triangle) 


Results of these commands are shown in Fig. 4.2. Typing <sp> enters the location of the crosshairs as a point. 
The ged identifies the point with an integer and adds the location to the current point set. The last point entered 
can be erased by typing #. The current point set can be cleared by typing @. On receiving the final <er>, points 
are connected in numerical order. 
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second point 


first point entered 
fourth point third point 


Fig. 4.2 —Building a Triangle 


Points in the current point set may be referenced by name using the $ operator. Thus, $n references the 
point numbered n. By using $, the triangle can be redrawn by entering: 


*L<cr> 

<position cursor><sp> 

<position cursor><sp> 

<position cursor> <sp> 

$0<cr> (reference point 0) 
<r. 


At the start of each command that includes stage 3, points, the current point set is empty. The point set 
from the previous command is saved and is accessible using the . operator. The . swaps points in the previous 


point set with those in the current set. The = operator can be used to identify the current points. To illustrate, 
the triangle just entered is used as the basis for drawing a quadrilateral: 


*L<cr> 

: (access the previous point set) 
= (identify the current points) 

# (erase the last point) 
<position cursor> <sp> (add a new point) 

$0<cr> (close the figure) 

<cr> 


Results of these commands are shown in Fig. 4.3. 
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Fig. 4.3— Accessing Previous Point Set 


Individual points from the previous point set can be referenced by using the . operator with $. The following 
will build a triangle that shares an edge with the quadrilateral: 


*Le<er> 

$.l<cr> (reference point 1 from the previous point set) 
$.2<cr> (reference point 2) 

<sp> (enter a new point) 

$0<cr> (or $.1 to close the figure) 

<er> 


Results of these points are shown in Fig. 4.4. 


point 1 from previous point set new point 


point 2 from previous point set 


Fig. 4.4—Referencing Points From Previous Point Set 
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A point can also be given a name. The > operator permits association of an uppercase letter with a point 
just entered. A simple example is: 


*L<er> 

<position cursor><sp> (enter a point) 

>A (name the point A) 
<position cursor><sp> 

<cr> 


In commands that follow, reference can be made to point A using the $ operator, as in: 


<position cursor> <sp> 
<cr> 


Drawing Curves 


Curves are interpolated from a sequence of three or more points. The A command generates a circular arc 
given three points on a circle. The arc is drawn starting at the first point, through the second point, and ending 
at the third point. A circle is an arc with first and third points coincident. The following is one way to draw 
a circle: 


*A<er> 

<position cursor><sp> 
<position cursor><sp> 
$0<cr> 

<cr> 


Editing Objects 
Addressing Objects 


An object is addressed by pointing to one of its handles. All objects have an object-handle. Usually the 
object-handle is the first point entered when the object was created. The objects command marks the location 
of each object-handle with an O. For example, to see the handles-of all the objects on the screen: 


*o —v<cr> 


Some objects, Lines for example, also have point-handles. Typically, each of the points entered when an ob- 
ject is constructed becomes a point-handle (an object-handleis also a point-handle). The pointscommand marks 
each of the point-handles. 


A handle is pointed to by including it within a defined-area. A defined-area is generated either with a com- 
mand line option or interactively with the graphic cursor. As an example, to delete one of the objects that was 
created on the screen: 


*De<cr> 

<position cursor><sp> (above and to the left of some 
object-handle) 

<position cursor><sp> (below and to the right of the 
object-handle) 

<¢r> (the defined-area should include 
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object-handle) 
<cr> (if all is well, delete the object) 


The defined-area is outlined with dotted lines. The reason for the seemingly extra <cr> at the end of the Delete 
command is to provide an opportunity to stop the command (using <rubout>) if the defined-area is not quite 
right. Every command that accepts a defined-area will wait for a confirming <er>. A new command is used 
to get fresh copy of the remaining objects. 


Defined-areas are entered as points in the same way that objects are created. Actually, a defined-area may 
be generated by giving anywhere from 0 to 30 points. Inputting zero points is useful to point to a single handle. 
It creates a small defined-area about the location of the terminating <er>. Using a zero point defined-area, 
the Delete command would be: 


*De<cer> 

<position cursor> (center crosshairs on object-handle) 
<er> (terminate defined-area) 

<er> (delete object) 


A defined-area can also be given as a command line option. For example, to delete everything in the display 
buffer the universe option (u) to the Delete command is used. The difference between the commands “D -u” 
and “e” should be understood. 


Changing Location of Object 


Objects are moved using the M command. The following creates a circle using the A command and then 
moves it. 


*M<cr> 
<position cursor><cr> (centered on object-handle) 
<cr> (establishes a pivot, marked with 


an asterisk) 
<position cursor><cr> (establishes a destination) 


The basic move operation relocates every point in each object addressed by the distance from the pivot to the 
destination. In this case, the pivot to be the object-handle was chosen; so effectively, the object-handle was 
moved to the destination point. 


Changing Shape of Object 


The B command generates a box and is a special case of generating lines. Given two points, it creates a rec- 
tangle such that the two points are at opposite corners. Sides of the rectangle lie parallel to edges of the screen. 
To draw a box: 


*Becr> 
<position cursor><sp> 
<position cursor> <cr> 


The B command generates point-handles at each vertex of the rectangle. The point command is used to mark 
the point-handles. The shape of an object can be altered by moving point-handles. The next example illustrates 
one way to double the height of a box (shown in Fig. 4.5). 


*M —pt+<cer> 
<position cursor><sp> (left of box, between top and 
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bottom edges) 
<position cursor><er> (right of box, below bottom edge) 
<position cursor><cr> (on top edge) 
<position cursor><cr> (directly below on bottom edge) 


TWO POINTS FOR BOX 


PIVOT 
DESTINATION 


TWO POINTS FOR DEFINED - AREA 


Fig. 4.5 —Growing a Box 


Because the points flag (p) is true, the operation is applied to each point-handle addressed. In this case, each 
point-handle within the defined-area is moved the distance from the pivot to the destination. If p were false, 
only the object-handle would have been addressed. 


Changing Size of Object 
The size of an object can be changed using the S command. This command scales objects by changing the 


distance from each handle of the object to a pivot by a factor. If a line of text is put on the screen, the following 
S commands produce the results shown in Fig. 4.6. 


*8 -f200<cr> (factor is in percent) 

<position cursor> (point to object-handle) 

<position cursor> (set pivot to rightmost character) 

<cr> 

*S -f50<er> 

.<er> (reference previous defined area) 

<position cursor> <cr> (set pivot above a character near the middle) 
<er> 
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*—_—__—_——— PIVOT FOR SCALE -f50 
A LINE OF TEXT 


fA LINE Dire TENGE — prvor FOR SCALE -f200 


ORIGINAL LINE 
OF TEXT 


Fig. 4.6 —Scaling Text 


A useful insight into the behavior of scaling is to note that the position of the pivot does not change. Also 
the defined-area is scaled to preserve its relationship to the graphical objects. 


Size of objects can also be changed by moving point-handles. A circle is generated with the C command as 
follows: 


*C<cr> 
<position cursor><sp> —_— (specify center) 
<position cursor><cr> (specify a point on the circle) 


The C command generates an arc with the first and third point at the point specified on the circle. The sec- 
ond point of the arc is located 180 degrees around the circle. One way to change the size of the circle is to move 
one of the point-handles (using " M —p" ). 


Size of text characters can be changed via a third mechanism. Character height is a property of a line of 
text. The E command allows changing character height as follows: 


*K —hheight<cr> (height is in universe units) 
<position cursor><cr> (point to object-handle) 
<cr> 


Changing Orientation of Object 


Orientation of an object can be altered using the R command. The command rotates each point of an object 
about a pivot by an angle. The following rotations used on a line of text produces results shown in Fig. 4.7: 


*R —a90<cr> (angle is in degrees) 

<position cursor><cr> (point to object-handle) 
<position cursor><cr> (set pivot to rightmost character) 
<er> 


*R —a—90<er> 


<I> (reference previous defined-area) 

<position cursor><cr> (set pivot to a character near the 
middle) 

Ser > 
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ORIGINAL TEXT 
: gia FOR ROTATE -a90 


ANOTHER LINE OF TEXT 
>< 


wi 
i 
mw 
Oo 
ANOTHER INE OF TEXT 
a | 
ce PIVOT FOR ROTATE -a-90 
= 
o 
= 
a 


Fig. 4.7—Rotating Text 


Changing Style or Width of Lines 


In the current editor, objects can be drawn from lines in any of five styles: solid (so), dashed (da), dot- 
dashed (dd), dotted (do), long-dashed (1d); and three widths: narrow (n), medium (m), bold (b). Style is con- 
trolled by the s option, width by w. The following creates a narrow width dotted line: 


*L —wn,sdo<cr> 
<position cursor><sp> 
<position cursor> <sp> 
<er> 


The following changes the line to bold dot-dashed: 


*K —wb,sdd<cer> 
<position cursor><cr> (point to object-handle of line) 
<cr> 


View Commands 


All of the drawn objects lie within a Cartesian plane, 65,534 units on each axis, known as the universe. Thus 
far only a small portion of the universe has been displayed on the display screen. The command: 


“=< er> 
provides a view of the entire universe. 


A mapping of a portion of the universe onto the display screen is called a window. The extent or magnifica- 
tion of a window is altered using the z command. To build a window that includes all of the objects drawn, the 
following is typed: 


*7<cr> 

<position cursor><sp> (above and to left of any object) 

<position cursor><cr> (below and to right, also end 
points) 

<er> (verify) 


Zooming can be either inor out. Zooming in, as with a camera lens, increases the magnification of the win- 


dow. The area outlined by points is expanded to fill the screen. Zooming out decreases magnification. The cur- 
rent window is shrunk so that it fits within the defined-area. Direction of zoom is controlled by the sense of 
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the out flag (o); o true means zoom out. 


The location of a window is altered using the v command. The view command moves the window so that 
a given point in the universe lies at a given location on the screen. 


*v<er> 
<position cursor> <cr> (locate a point in the universe) 
<position cursor> <cr> (locate a point on the screen) 


The v command also provides access to several predefined windows. The " v—u" command has been pre- 
viously displayed. The v command with the —h option displays the home-window. The home-window circum- 
scribes all objects in the universe. The result is similar to that of the example using the z command given earlier. 

The v command permits selection of a window on a particular region. The universe is partitioned into 25 
equal-sized regions. Regions are numbered from 1 to 25 beginning at the lower left and proceeding toward the 


upper right. Region 18, the center of the universe, is used as the default region by drawing commands such as 
plot(1) and vtoc(1). 


Other Commands 
Interacting With Files 
The w command saves contents of the display buffer by copying it to a file. 
*w filename<cr> 


The contents of filename will be a GPS, thus it can be displayed using any of the device filters (e.g., td(1)) or 
read back into ged. 


A GPS is read into the editor using the r command: 
*r filename<cr> 
The GPS from filename is appended to the display buffer and then displayed. Because the r command does not 
change the current window, only some (or none) of the objects read may be visible. A useful command sequence 


to view everything read is: 


*r —e—filename<cr> 
*y —h<cr> 


The display function of the r command is inhibited by setting the echo flag (e) to false; the “v —h” command 
enables windows and displays the full display buffer. 


The r command may also be used to input text files. The form is 
r2 —option(s) filename<cr> 


followed by a single point to locate the first line of text. A text object is created for each line of text from 
filename. Options to r command are the same as those for the T command. 


Leaving Editor 


The q command is used to terminate an editing session. As with the text editor ed(1), q responds with ? 
if the internal buffer has been modified since the last w command. A second q command forces exit. 
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Other Useful Information 
One-Line UNIX System Escape: As in ed(1), the ! provides a temporary escape to the shell. 
Typing Ahead: Most programs under the UNIX operating system allow a user to type input before the 
program is ready to receive it. In general, this is not the case with ged; characters typed before the prompt 


are lost. 


Speeding Things Up: Displaying contents of the display buffer can be time consuming, particularly if 
much text is involved. Wise use of two flags to control what gets displayed can make life more pleasant: 


e The echo flag (e) controls echoing of new additions to the display buffer. 
e The text flag (t) controls whether text will be outlined or drawn. 
Cc. Command Summary 
In this summary: 
e Characters actually typed are printed in boldface. 
e Command stages are underlined. 
e Arguments surrounded by brackets (e.g., [...]) are optional. 


e Parentheses surrounding arguments separated by or means that exactly one of the arguments must be 
given. 


For example, the delete command accepts the arguments —universe, —view, and points. 
Construct Commands 


Arc [—echo,style,width] points 

Box [—echo,style,width] points 

Circle [—echo,style,width] points 

Hardware [—echo] text points 

Lines [—echo,style,width] points 

Text [—angle,echo,height,midpoint,rightpoint,text,width]§ text points 


Edit Commands 


Delete (—(universe or view) or points) 

Edit [—angle,echo,height,style,width] (—(universe or view) or points) 
Kopy [—echo,points,x] points pivot destination 

Move [—echo,points,x] points pivot destination 

Rotate |—angle,echo,kopy,x] points pivot destination 

Scale [—echo,factor,kopy,x] points pivot destination 


View Commands 


coordinates points 
erase 
new 


6/82 ISSUE 1 GRAPHICS GUIDE 


objects (—(universe or view) or points) 

points (—(labelled-points or universe or view) or points) 

view (—(home or universe or region) or [—x] pivot destination) 
x [-view] points 

zoom [—out] points 


Other Commands 


quit or Quit 

read [—angle,echo,height,midpoint,rightpoint,text,width]§ filename [destination] 
set [—angle,echo,factor,height,kopy,midpoint,points,§ rightpoint,style,text,width,x] 
write filename 

!command 

z 


Options 
Options specify parameters used to construct, edit, and view graphical objects. If a parameter used by a com- 
mand is not specified as an option, the default value for the parameter will be used. The format of command 
options is: 
—option|, option] 


where option is keyletter [ value]. Flags assume values of true or false indicated by + and —, respectively. If no 
value is given with a flag, true is assumed. Object options are: 


anglen Specify an angle of n degrees. 

echo When true, changes to the display buffer will be echoed on the screen. 

factor n Specify a scale factor of n percent. 

heightn Specify height of text to be n universe-units (n greater than or equal to 0 and less than 
1280). 

kopy Commands Scale and Rotate can be used to either create new objects or to alter old ones. 


When the kopy flag is true, new objects are created. 


midpoint When true, midpoint of a text string to locate the string is used. 

out When true, reduce magnification during zoom. 

points When true, operate on points; otherwise, operate on objects. 

rightpoint When true, rightmost point of a text string to locate the string is used. 
styletype Specify line style to be one of following types 
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type style 
so solid 
da _—_ dashed 
dd dot-dashed 
do _ dotted 
Id —_ long-dashed a 
text Most text is drawn as a sequence of lines. This can sometimes be painfully slow. When the 


text flag (t) is false, text strings are outlined rather than drawn. 
widthtype Specify line width to be one of following types 
n _inarrow 
m medium 


b bold 


x One way to find the center of a rectangular area is to draw diagonals of the rectangle. 
When the x flag is true, defined areas are drawn with their diagonals. 


Area options are: 


home Reference home-window. 

regionn Reference region n. 

universe Reference universe-window. 

view Reference those objects currently in view. 


D. Examples 
The following examples are used to illustrate use of the graphic editor. 


Example 1: Text Centered Within a Circle 


*C<er> 

<position cursor> <sp> (establish center) 

<position cursor><cr> (establish radius) 

*T —m<cr> (text to be centered) 

some text<cr> 

$.0<cr> (first point from previous set, 


i.e., circle center) 


Figure 4.8 shows the output of these commands. 
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Fig. 4.8—Text Centered Within a Circle 


Example 2: Making Notes on a Plot 


*! gas: plot -g >A<cr> 
*r-e-— Ac<cr> 

*L -sdo<er> 

<position cursor><sp> 
<position cursor><sp> 
<position cursor> <sp> 
<er> 

*s —h150,wn<cr> 

*T -r<cr> 


(generate a plot into File A) 
(input plot, but do no display) 
(draw dotted lines) 


(end of lines) 
(set text to 150, line width to narrow) 
(right justify text) 


threshold beyond which nothing matters <cr> 


<postion cursor> 
*T -a-90<cr> 


(set right point of text) 
(rotate text —90 degrees) 


threshold beyond which nothing matters <cr> 


<postion cursor> <cr> 

cab es aie 

<position cursor> <sp> 
<position cursor> <cr> 

*T —h300,wm,m<cr> 

SOME KIND OF PLOT <cr> 
<position cursor> <cr> 


Figure 4.9 shows the output of these commands. 


(set top end of text) 
(find center of plot) 
(top left of plot) 
(bottom right) 
(build title) 


(set title above plot) 
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SOME KIND OF PLOT 


THRESHOLD BEYOND WHICH NOTHING MATTERS 


|= 
rr 
= 
= 
o 
|= 
— 
Is 
fs 
Oo 
on] 
ain 
= 
Oo 
= 
= 
[==] 
le 
Oo 
m4 
ja 
aa 
|- 


Fig. 4.9—Making Notes on a Plot 
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